Integration Examples

Outter's Assistants API enables developers to integrate AI-powered conversational agents into their platforms. Whether you're building a customer support chatbot, a guided onboarding assistant, or an AI copilot for automating workflows, Outter provides a structured, API-driven approach to embedding intelligent assistants into your applications.

Our assistants leverage fine-tuned models enriched with real-world data, such as event databases for ticketing chatbots or curricula for education-focused assistants. This ensures contextually accurate and highly relevant responses.

Node.js

Ticketing Chatbot

This example queries the ticketing chatbot for event recommendations.

const fetch = require("node-fetch");

const payload = {
  user_id: "u7ef95ca7",
  session_id: "chat-session-fe385582",
  messages: [{ role: "user", content: "What are some fun things to do in Barcelona today?" }]
};

fetch("https://api.outter.ai/v2/ai/assistants/chat", {
  method: "POST",
  headers: {
    "Authorization": "X-API-Key YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify(payload)
})
  .then((res) => res.json())
  .then((data) => {
    console.log("Chatbot Reply:", data.reply);
  })
  .catch((err) => console.error("API Error:", err));

✅ What this does:

• Sends a user message to the chatbot.
• Retrieves Barcelona event suggestions with ticket purchase links.
• Outputs the chatbot's reply.

---

Laravel (PHP)

Onboarding Assistant (Teacher Copilot)

This example guides a teacher through structured course creation steps.

use Illuminate\Support\Facades\Http;

$data = [
    'user_id'    => 'u9d27c63a',
    'session_id' => 'onboarding-session-786c08b0',
    'step'       => 1,
    'messages'   => [
        ['role' => 'system', 'content' => 'You are an expert in online course creation. Guide the teacher through structured onboarding.'],
        ['role' => 'user', 'content' => 'How do I get started creating my course?']
    ]
];

$response = Http::withHeaders([
    'Authorization' => 'X-API-Key YOUR_API_KEY',
])->post('https://api.outter.ai/v2/ai/assistants/onboarding', $data);

if ($response->ok()) {
    $assistantReply = $response->json('reply');
    echo "Assistant Reply: " . $assistantReply;
} else {
    echo "Error: " . $response->status();
}

✅ What this does:

• Sends a step-by-step onboarding query for teachers.
• Receives guidance on defining course topics and objectives.
• Ensures sequential learning by tracking onboarding steps.

---

.NET (C#)

AI Copilot for Workflow Automation

This example schedules a meeting using an AI assistant.

using System;
using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;
using System.Text.Json;
using System.Threading.Tasks;

class Program
{
    private static readonly HttpClient client = new HttpClient();

    static async Task Main()
    {
        var requestObj = new
        {
            user_id = "u123456",
            session_id = "copilot-session-xyz",
            messages = new[]
            {
                new { role = "user", content = "Schedule a meeting with the sales team next week." }
            }
        };

        string json = JsonSerializer.Serialize(requestObj);
        var content = new StringContent(json, Encoding.UTF8, "application/json");
        client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("X-API-Key", "YOUR_API_KEY");

        var response = await client.PostAsync("https://api.outter.ai/v2/ai/assistants/copilot", content);
        string responseJson = await response.Content.ReadAsStringAsync();

        if (response.IsSuccessStatusCode)
        {
            Console.WriteLine("Copilot Response: " + responseJson);
        }
        else
        {
            Console.WriteLine($"API Error: {response.StatusCode} - {responseJson}");
        }
    }
}

✅ What this does:

• Sends a workflow automation request to schedule a meeting.
• The assistant understands context and confirms scheduling details.
• Uses structured API responses to integrate with a calendar system.

---